@hyperlex/mammoth 1.4.10 → 1.4.21

package/.eslintrc.json

@@ -52,7 +52,6 @@
     "no-spaced-func": ["error"],
     "no-trailing-spaces": ["error", {"skipBlankLines": true}],
     "no-whitespace-before-property": ["error"],
-    "object-curly-spacing": ["error", "never"],
     "one-var": ["error", "never"],
     "semi": ["error", "always"],
     "semi-spacing": ["error", {"before": false}],

package/.idea/compiler.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="TypeScriptCompiler">
+    <option name="memoryLimit" value="10240" />
+  </component>
+</project>

package/.idea/inspectionProfiles/Project_Default.xml

@@ -0,0 +1,6 @@
+<component name="InspectionProjectProfileManager">
+  <profile version="1.0">
+    <option name="myName" value="Project Default" />
+    <inspection_tool class="Eslint" enabled="true" level="WARNING" enabled_by_default="true" />
+  </profile>
+</component>

package/.idea/mammoth.js.iml

@@ -1,11 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <module type="WEB_MODULE" version="4">
   <component name="NewModuleRootManager">
-    <content url="file://$MODULE_DIR$">
-      <excludeFolder url="file://$MODULE_DIR$/temp" />
-      <excludeFolder url="file://$MODULE_DIR$/.tmp" />
-      <excludeFolder url="file://$MODULE_DIR$/tmp" />
-    </content>
+    <content url="file://$MODULE_DIR$" />
     <orderEntry type="inheritedJdk" />
     <orderEntry type="sourceFolder" forTests="false" />
   </component>

package/.idea/vcs.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <project version="4">
   <component name="VcsDirectoryMappings">
-    <mapping directory="$PROJECT_DIR$" vcs="Git" />
+    <mapping directory="" vcs="Git" />
   </component>
 </project>

package/.idea/workspace.xml

@@ -0,0 +1,173 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="AutoImportSettings">
+    <option name="autoReloadType" value="SELECTIVE" />
+  </component>
+  <component name="ChangeListManager">
+    <list default="true" id="fb2a5579-0030-43eb-b358-b723f29ab6e1" name="Changes" comment="Don't ignore browser build and commit yarn.lock">
+      <change beforePath="$PROJECT_DIR$/package.json" beforeDir="false" afterPath="$PROJECT_DIR$/package.json" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/yarn.lock" beforeDir="false" afterPath="$PROJECT_DIR$/yarn.lock" afterDir="false" />
+    </list>
+    <option name="SHOW_DIALOG" value="false" />
+    <option name="HIGHLIGHT_CONFLICTS" value="true" />
+    <option name="HIGHLIGHT_NON_ACTIVE_CHANGELIST" value="false" />
+    <option name="LAST_RESOLUTION" value="IGNORE" />
+  </component>
+  <component name="EmbeddingIndexingInfo">
+    <option name="cachedIndexableFilesCount" value="119" />
+    <option name="fileBasedEmbeddingIndicesEnabled" value="true" />
+  </component>
+  <component name="Git.Settings">
+    <option name="RECENT_GIT_ROOT_PATH" value="$PROJECT_DIR$" />
+  </component>
+  <component name="McpProjectServerCommands">
+    <commands />
+    <urls />
+  </component>
+  <component name="ProjectColorInfo"><![CDATA[{
+  "associatedIndex": 8
+}]]></component>
+  <component name="ProjectId" id="39nIvtlpBCXmNpPviWMaHuovjPb" />
+  <component name="ProjectViewState">
+    <option name="autoscrollFromSource" value="true" />
+    <option name="hideEmptyMiddlePackages" value="true" />
+    <option name="showLibraryContents" value="true" />
+  </component>
+  <component name="PropertiesComponent"><![CDATA[{
+  "keyToString": {
+    "ModuleVcsDetector.initialDetectionPerformed": "true",
+    "RunOnceActivity.MCP Project settings loaded": "true",
+    "RunOnceActivity.ShowReadmeOnStart": "true",
+    "RunOnceActivity.git.unshallow": "true",
+    "RunOnceActivity.typescript.service.memoryLimit.init": "true",
+    "com.intellij.ml.llm.matterhorn.ej.ui.settings.DefaultModelSelectionForGA.v1": "true",
+    "git-widget-placeholder": "Rebasing master",
+    "javascript.preferred.runtime.type.id": "node",
+    "junie.onboarding.icon.badge.shown": "true",
+    "last_opened_file_path": "/Users/sdiaz/work/mammoth.js",
+    "node.js.detected.package.eslint": "true",
+    "node.js.detected.package.tslint": "true",
+    "node.js.selected.package.eslint": "(autodetect)",
+    "node.js.selected.package.tslint": "(autodetect)",
+    "nodejs_package_manager_path": "yarn",
+    "to.speed.mode.migration.done": "true",
+    "vue.rearranger.settings.migration": "true"
+  }
+}]]></component>
+  <component name="SharedIndexes">
+    <attachedChunks>
+      <set>
+        <option value="bundled-js-predefined-d6986cc7102b-9b0f141eb926-JavaScript-WS-253.30387.83" />
+      </set>
+    </attachedChunks>
+  </component>
+  <component name="TaskManager">
+    <task active="true" id="Default" summary="Default task">
+      <changelist id="fb2a5579-0030-43eb-b358-b723f29ab6e1" name="Changes" comment="" />
+      <created>1771325642160</created>
+      <option name="number" value="Default" />
+      <option name="presentableId" value="Default" />
+      <updated>1771325642160</updated>
+      <workItem from="1771325643308" duration="3144000" />
+    </task>
+    <task id="LOCAL-00001" summary="Don't ignore browser build and commit yarn.lock">
+      <option name="closed" value="true" />
+      <created>1771336874338</created>
+      <option name="number" value="00001" />
+      <option name="presentableId" value="LOCAL-00001" />
+      <option name="project" value="LOCAL" />
+      <updated>1771336874338</updated>
+    </task>
+    <task id="LOCAL-00002" summary="Publish package to npm registry">
+      <option name="closed" value="true" />
+      <created>1771337011188</created>
+      <option name="number" value="00002" />
+      <option name="presentableId" value="LOCAL-00002" />
+      <option name="project" value="LOCAL" />
+      <updated>1771337011188</updated>
+    </task>
+    <task id="LOCAL-00003" summary="Publish package to npm registry">
+      <option name="closed" value="true" />
+      <created>1771337081623</created>
+      <option name="number" value="00003" />
+      <option name="presentableId" value="LOCAL-00003" />
+      <option name="project" value="LOCAL" />
+      <updated>1771337081623</updated>
+    </task>
+    <task id="LOCAL-00004" summary="Don't ignore browser build and commit yarn.lock">
+      <option name="closed" value="true" />
+      <created>1771337138560</created>
+      <option name="number" value="00004" />
+      <option name="presentableId" value="LOCAL-00004" />
+      <option name="project" value="LOCAL" />
+      <updated>1771337138560</updated>
+    </task>
+    <task id="LOCAL-00005" summary="Don't ignore browser build and commit yarn.lock">
+      <option name="closed" value="true" />
+      <created>1771337146350</created>
+      <option name="number" value="00005" />
+      <option name="presentableId" value="LOCAL-00005" />
+      <option name="project" value="LOCAL" />
+      <updated>1771337146350</updated>
+    </task>
+    <task id="LOCAL-00006" summary="Don't ignore browser build and commit yarn.lock">
+      <option name="closed" value="true" />
+      <created>1771337192606</created>
+      <option name="number" value="00006" />
+      <option name="presentableId" value="LOCAL-00006" />
+      <option name="project" value="LOCAL" />
+      <updated>1771337192606</updated>
+    </task>
+    <option name="localTasksCounter" value="7" />
+    <servers />
+  </component>
+  <component name="TypeScriptGeneratedFilesManager">
+    <option name="version" value="3" />
+  </component>
+  <component name="Vcs.Log.Tabs.Properties">
+    <option name="RECENT_FILTERS">
+      <map>
+        <entry key="Branch">
+          <value>
+            <list>
+              <RecentGroup>
+                <option name="FILTER_VALUES">
+                  <option value="HEAD" />
+                </option>
+              </RecentGroup>
+            </list>
+          </value>
+        </entry>
+      </map>
+    </option>
+    <option name="TAB_STATES">
+      <map>
+        <entry key="MAIN">
+          <value>
+            <State>
+              <option name="FILTERS">
+                <map>
+                  <entry key="branch">
+                    <value>
+                      <list>
+                        <option value="HEAD" />
+                      </list>
+                    </value>
+                  </entry>
+                </map>
+              </option>
+            </State>
+          </value>
+        </entry>
+      </map>
+    </option>
+  </component>
+  <component name="VcsManagerConfiguration">
+    <option name="CHECK_CODE_SMELLS_BEFORE_PROJECT_COMMIT" value="false" />
+    <option name="CHECK_NEW_TODO" value="false" />
+    <MESSAGE value="Publish package to npm registry" />
+    <MESSAGE value="Dynamic styleMaps for paragraphs&#10;&#10;# Conflicts:&#10;#&#9;mammoth.browser.js&#10;#&#9;mammoth.browser.min.js" />
+    <MESSAGE value="Don't ignore browser build and commit yarn.lock" />
+    <option name="LAST_COMMIT_MESSAGE" value="Don't ignore browser build and commit yarn.lock" />
+  </component>
+</project>

package/NEWS

@@ -1,3 +1,58 @@
+# 1.4.21
+
+* Ignore w:u elements when w:val is missing.
+
+# 1.4.20
+
+* Emit warning instead of throwing exception when image file cannot be found for
+  a:blip elements.
+
+# 1.4.19
+
+* Add TypeScript declarations.
+
+# 1.4.18
+
+* When extracting raw text, convert tab elements to tab characters.
+
+* Handle internal hyperlinks created with complex fields.
+
+* Update JSZip to 3.2.0. This addresses CVE-2021-23413 in JSZip.
+
+# 1.4.17
+
+* Handle w:num with invalid w:abstractNumId.
+* Update underscore to 1.13.1.
+
+# 1.4.16
+
+* Convert symbols in supported fonts to corresponding Unicode characters.
+
+# 1.4.15
+
+* Support numbering defined by paragraph style.
+
+# 1.4.14
+
+* Add style mapping for all caps.
+
+# 1.4.13
+
+* Use package-lock.json instead of npm-shrinkwrap.json.
+
+# 1.4.12
+
+* Handle underline elements where w:val is "none".
+
+# 1.4.11
+
+* Re-publishing to remove superfluous files.
+
+# 1.4.10
+
+* Read font size for runs.
+* Support soft hyphens.
+
 # 1.4.9
 
 * Allow hyperlinks to be collapsed.

package/README.md

@@ -1,7 +1,7 @@
 # Mammoth .docx to HTML converter
 
 Mammoth is designed to convert .docx documents,
-such as those created by Microsoft Word,
+such as those created by Microsoft Word, Google Docs and LibreOffice,
 and convert them to HTML.
 Mammoth aims to produce simple and clean HTML by using semantic information in the document,
 and ignoring other details.
@@ -104,18 +104,19 @@ Where `custom-style-map` looks something like:
     p[style-name='Aside Heading'] => div.aside > h2:fresh
     p[style-name='Aside Text'] => div.aside > p:fresh
 
-Lines beginning with `#` will be ignored.
+A description of the syntax for style maps can be found in the section ["Writing style maps"](#writing-style-maps).
 
 #### Markdown
 
+Markdown support is deprecated.
+Generating HTML and using a separate library to convert the HTML to Markdown is recommended,
+and is likely to produce better results.
+
 Using `--output-format=markdown` will cause Markdown to be generated.
 For instance:
 
     mammoth document.docx --output-format=markdown
 
-Markdown support is still in its early stages,
-so you may find some features are unsupported.
-
 ### Library
 
 In node.js, mammoth can be required in the usual way:
@@ -167,7 +168,7 @@ Mammoth maps some common .docx styles to HTML elements.
 For instance,
 a paragraph with the style name `Heading 1` is converted to a `h1` element.
 You can pass in a custom map for styles by passing an options object with a `styleMap` property as a second argument to `convertToHtml`.
-A description of the syntax for style maps can be found in the section "Writing style maps".
+A description of the syntax for style maps can be found in the section ["Writing style maps"](#writing-style-maps).
 For instance, if paragraphs with the style name `Section Title` should be converted to `h1` elements,
 and paragraphs with the style name `Subsection Title` should be converted to `h2` elements:
 
@@ -343,7 +344,7 @@ Converts the source document to HTML.
      ignoring blank lines and lines starting with `#`:
      If `options.styleMap` is an array,
      each element is expected to be a string representing a single style mapping.
-     See "Writing style maps" for a reference to the syntax for style maps.
+     See ["Writing style maps"](#writing-style-maps) for a reference to the syntax for style maps.
 
   * `includeEmbeddedStyleMap`: by default,
      if the document contains an embedded style map, then it is combined with the default style map.
@@ -543,10 +544,12 @@ var options = {
 Or if you want paragraphs that have been explicitly set to use monospace fonts to represent code:
 
 ```javascript
+const monospaceFonts = ["consolas", "courier", "courier new"];
+
 function transformParagraph(paragraph) {
     var runs = mammoth.transforms.getDescendantsOfType(paragraph, "run");
     var isMatch = runs.length > 0 && runs.every(function(run) {
-        return run.font && fonts.indexOf(run.font.toLowerCase()) !== -1;
+        return run.font && monospaceFonts.indexOf(run.font.toLowerCase()) !== -1;
     });
     if (isMatch) {
         return {
@@ -624,7 +627,7 @@ You can specify this by using the `:fresh` modifier:
 
 `p[style-name='Heading 1'] => h1:fresh`
 
-The two consective `Heading 1` .docx paragraphs will then be converted to two separate `h1` elements.
+The two consecutive `Heading 1` .docx paragraphs will then be converted to two separate `h1` elements.
 
 Reusing elements is useful in generating more complicated HTML structures.
 For instance, suppose your .docx contains asides.
@@ -725,6 +728,17 @@ strike
 Note that this matches text that has had strikethrough explicitly applied to it.
 It will not match any text that is struckthrough because of its paragraph or run style.
 
+#### All caps
+
+Match explicitly all caps text:
+
+```
+all-caps
+```
+
+Note that this matches text that has had all caps explicitly applied to it.
+It will not match any text that is all caps because of its paragraph or run style.
+
 #### Small caps
 
 Match explicitly small caps text:
@@ -736,6 +750,15 @@ small-caps
 Note that this matches text that has had small caps explicitly applied to it.
 It will not match any text that is small caps because of its paragraph or run style.
 
+#### Ignoring document elements
+
+Use `!` to ignore a document element.
+For instance, to ignore any paragraph with the style `Comment`:
+
+```
+p[style-name='Comment'] => !
+```
+
 ### HTML paths
 
 #### Single elements
@@ -798,15 +821,6 @@ div.aside > h2
 
 You can nest elements to any depth.
 
-#### Ignoring document elements
-
-Use `!` to ignore a document element.
-For instance, to ignore any paragraph with the style `Comment`:
-
-```
-p[style-name='Comment'] => !
-```
-
 ## Upgrading to later versions
 
 ### 1.0.0
@@ -881,3 +895,10 @@ Thanks to the following people for their contributions to Mammoth:
 * [Jacob Wang](https://github.com/jaceyshome)
 
   * Supporting styles defined without names
+
+## Donations
+
+If you'd like to say thanks, feel free to [make a donation through Ko-fi](https://ko-fi.com/S6S01MG20).
+
+If you use Mammoth as part of your business,
+please consider supporting the ongoing maintenance of Mammoth by [making a weekly donation through Liberapay](https://liberapay.com/mwilliamson/donate).

package/lib/document-to-html.js

@@ -130,6 +130,9 @@ function DocumentConversion(options, comments) {
         if (run.isSmallCaps) {
             paths.push(findHtmlPathForRunProperty("smallCaps"));
         }
+        if (run.isAllCaps) {
+            paths.push(findHtmlPathForRunProperty("allCaps"));
+        }
         if (run.isStrikethrough) {
             paths.push(findHtmlPathForRunProperty("strikethrough", "s"));
         }

package/lib/documents.js

@@ -73,9 +73,11 @@ function Run(children, properties) {
         isUnderline: properties.isUnderline,
         isItalic: properties.isItalic,
         isStrikethrough: properties.isStrikethrough,
+        isAllCaps: properties.isAllCaps,
         isSmallCaps: properties.isSmallCaps,
         verticalAlignment: properties.verticalAlignment || verticalAlignment.baseline,
         font: properties.font || null,
+        fontSize: properties.fontSize || null,
         size: properties.size || null,
         color: properties.color || null,
         highlight: properties.highlight || null

package/lib/docx/body-reader.js

@@ -1,6 +1,7 @@
 exports.createBodyReader = createBodyReader;
 exports._readNumberingProperties = readNumberingProperties;
 
+var dingbatToUnicode = require("dingbat-to-unicode");
 var _ = require("underscore");
 
 var documents = require("../documents");
@@ -85,17 +86,23 @@ function BodyReader(options) {
 
     function readRunProperties(element) {
         return readRunStyle(element).map(function(style) {
+            var fontSizeString = element.firstOrEmpty("w:sz").attributes["w:val"];
+            // w:sz gives the font size in half points, so halve the value to get the size in points
+            var fontSize = /^[0-9]+$/.test(fontSizeString) ? parseInt(fontSizeString, 10) / 2 : null;
+
             return {
                 type: "runProperties",
                 styleId: style.styleId,
                 styleName: style.name,
                 verticalAlignment: element.firstOrEmpty("w:vertAlign").attributes["w:val"],
                 font: element.firstOrEmpty("w:rFonts").attributes["w:ascii"],
+                fontSize: fontSize,
                 size: element.firstOrEmpty("w:sz").attributes["w:val"],
                 isBold: readBooleanElement(element.first("w:b")),
-                isUnderline: readBooleanElement(element.first("w:u")),
+                isUnderline: readUnderline(element.first("w:u")),
                 isItalic: readBooleanElement(element.first("w:i")),
                 isStrikethrough: readBooleanElement(element.first("w:strike")),
+                isAllCaps: readBooleanElement(element.first("w:caps")),
                 isSmallCaps: readBooleanElement(element.first("w:smallCaps")),
                 color: element.firstOrEmpty("w:color").attributes["w:val"],
                 highlight: element.firstOrEmpty("w:highlight").attributes["w:val"]
@@ -103,6 +110,15 @@ function BodyReader(options) {
         });
     }
 
+    function readUnderline(element) {
+        if (element) {
+            var value = element.attributes["w:val"];
+            return value !== undefined && value !== "false" && value !== "0" && value !== "none";
+        } else {
+            return false;
+        }
+    }
+
     function readBooleanElement(element) {
         if (element) {
             var value = element.attributes["w:val"];
@@ -153,28 +169,33 @@ function BodyReader(options) {
         } else if (type === "end") {
             complexFieldStack.pop();
         } else if (type === "separate") {
-            var href = parseHyperlinkFieldCode(currentInstrText.join(''));
-            var complexField = href === null ? unknownComplexField : {type: "hyperlink", href: href};
+            var hyperlinkOptions = parseHyperlinkFieldCode(currentInstrText.join(''));
+            var complexField = hyperlinkOptions === null ? unknownComplexField : {type: "hyperlink", options: hyperlinkOptions};
             complexFieldStack.pop();
             complexFieldStack.push(complexField);
         }
         return emptyResult();
     }
 
-    function currentHyperlinkHref() {
+    function currentHyperlinkOptions() {
         var topHyperlink = _.last(complexFieldStack.filter(function(complexField) {
             return complexField.type === "hyperlink";
         }));
-        return topHyperlink ? topHyperlink.href : null;
+        return topHyperlink ? topHyperlink.options : null;
     }
 
     function parseHyperlinkFieldCode(code) {
-        var result = /\s*HYPERLINK "(.*)"/.exec(code);
-        if (result) {
-            return result[1];
-        } else {
-            return null;
+        var externalLinkResult = /\s*HYPERLINK "(.*)"/.exec(code);
+        if (externalLinkResult) {
+            return {href: externalLinkResult[1]};
+        }
+
+        var internalLinkResult = /\s*HYPERLINK\s+\\l\s+"(.*)"/.exec(code);
+        if (internalLinkResult) {
+            return {anchor: internalLinkResult[1]};
         }
+
+        return null;
     }
 
     function readInstrText(element) {
@@ -182,6 +203,24 @@ function BodyReader(options) {
         return emptyResult();
     }
 
+    function readSymbol(element) {
+        // See 17.3.3.30 sym (Symbol Character) of ECMA-376 4th edition Part 1
+        var font = element.attributes["w:font"];
+        var char = element.attributes["w:char"];
+        var unicodeCharacter = dingbatToUnicode.hex(font, char);
+        if (unicodeCharacter == null && /^F0..$/.test(char)) {
+            unicodeCharacter = dingbatToUnicode.hex(font, char.substring(2));
+        }
+
+        if (unicodeCharacter == null) {
+            return emptyResultWithMessages([warning(
+                "A w:sym element with an unsupported character was ignored: char " +  char + " in font " + font
+            )]);
+        } else {
+            return elementResult(new documents.Text(unicodeCharacter.string));
+        }
+    }
+
     function noteReferenceReader(noteType) {
         return function(element) {
             var noteId = element.attributes["w:id"];
@@ -221,7 +260,7 @@ function BodyReader(options) {
                     styleId: style.styleId,
                     styleName: style.name,
                     alignment: element.firstOrEmpty("w:jc").attributes["w:val"],
-                    numbering: readNumberingProperties(element.firstOrEmpty("w:numPr"), numbering),
+                    numbering: readNumberingProperties(style.styleId, element.firstOrEmpty("w:numPr"), numbering),
                     indent: readParagraphIndent(element.firstOrEmpty("w:ind")),
                     spacing: readParagraphSpacing(element.firstOrEmpty("w:spacing")),
                     border: readParagraphBorders(element.firstOrEmpty("w:pBdr"))
@@ -234,9 +273,9 @@ function BodyReader(options) {
                     var properties = _.find(children, isRunProperties);
                     children = children.filter(negate(isRunProperties));
 
-                    var hyperlinkHref = currentHyperlinkHref();
-                    if (hyperlinkHref !== null) {
-                        children = [new documents.Hyperlink(children, {href: hyperlinkHref})];
+                    var hyperlinkOptions = currentHyperlinkOptions();
+                    if (hyperlinkOptions !== null) {
+                        children = [new documents.Hyperlink(children, hyperlinkOptions)];
                     }
 
                     return new documents.Run(children, properties);
@@ -254,6 +293,10 @@ function BodyReader(options) {
         "w:noBreakHyphen": function() {
             return elementResult(new documents.Text("\u2011"));
         },
+        "w:softHyphen": function(element) {
+            return elementResult(new documents.Text("\u00AD"));
+        },
+        "w:sym": readSymbol,
         "w:hyperlink": function(element) {
             var relationshipId = element.attributes["r:id"];
             var anchor = element.attributes["w:anchor"];
@@ -451,7 +494,12 @@ function BodyReader(options) {
     function readBlip(element, blip) {
         var properties = element.first("wp:docPr").attributes;
         var altText = isBlank(properties.descr) ? properties.title : properties.descr;
-        return readImage(findBlipImageFile(blip), altText);
+        var blipImageFile = findBlipImageFile(blip);
+        if (blipImageFile === null) {
+            return emptyResultWithMessages([warning("Could not find image file for a:blip element")]);
+        } else {
+            return readImage(blipImageFile, altText);
+        }
     }
 
     function isBlank(value) {
@@ -463,12 +511,14 @@ function BodyReader(options) {
         var linkRelationshipId = blip.attributes["r:link"];
         if (embedRelationshipId) {
             return findEmbeddedImageFile(embedRelationshipId);
-        } else {
+        } else if (linkRelationshipId) {
             var imagePath = relationships.findTargetByRelationshipId(linkRelationshipId);
             return {
                 path: imagePath,
                 read: files.read.bind(files, imagePath)
             };
+        } else {
+            return null;
         }
     }
 
@@ -512,7 +562,14 @@ function BodyReader(options) {
 }
 
 
-function readNumberingProperties(element, numbering) {
+function readNumberingProperties(styleId, element, numbering) {
+    if (styleId != null) {
+        var levelByStyleId = numbering.findLevelByParagraphStyleId(styleId);
+        if (levelByStyleId != null) {
+            return levelByStyleId;
+        }
+    }
+
     var level = element.firstOrEmpty("w:ilvl").attributes["w:val"];
     var numId = element.firstOrEmpty("w:numId").attributes["w:val"];
     if (level === undefined || numId === undefined) {